# SAML SSO - Azure

The ABsmartly Web Console supports SAML SSO with Azure. This guide will walk you through the steps to get it set up!

## Configuring Azure

1. Go to the [Microsoft Entra admin center](https://entra.microsoft.com/) and sign in with your Azure account.
2. [Click this link](https://entra.microsoft.com/#view/Microsoft_AAD_IAM/AppGalleryBladeV2) or head to **Identity** > **Applications** > **Enterprise Applications** > **All applications** > **New application**.

![A screenshot of the New application button](/assets/images/new_application-f54f75d92a3da68943d311a0a0e72def.png)

3. In the **Browse Microsoft Entra Gallery** page, click **+ Create your own application**.

![A screenshot of the Create application button](/assets/images/create_application-7e4ab72487c6804bbd53131733e74791.png)

4. Name the application **ABsmartly** and leave the radio button on **Integrate any other application you don't find in the gallery (Non-gallery)**.

![A screenshot of the completed 'New application' form](/assets/images/application_info-b156217ccfbf3a6a1c50f56dbf418643.png)

5. Click **Create** and you will be redirected to the Overview page of your new application.

> **info**
>
> Feel free to add [the ABsmartly logo](https://docs.absmartly.com/assets/files/logo-0532e45efbb50515b2d04a56e20f1d5a.png) to the application in **Properties** > **Logo**.
>
> ![The ABsmartly logo](/assets/images/logo-0532e45efbb50515b2d04a56e20f1d5a.png)

6. In the inner left pane, click on **Single sign-on** and **SAML**.

![A screenshot of the Single sign-on and SAML buttons](/assets/images/sign_on_saml-039817f75f4aa664d4f22d48bb57191e.png)

7. Next to **Basic SAML Configuration**, click **Edit** and input the following info:

   * **Identifier (Entity ID)**: `absmartly-<your-assigned-subdomain>`
   * **Reply URL (Assertion Consumer Service URL)**: `https://<your-assigned-subdomain>.absmartly.com/auth/saml/azure/callback`
   * **Sign on URL**: `https://<your-assigned-subdomain>.absmartly.com`

   ![A screenshot of the Basic SAML Configuration panel and the Edit button](/assets/images/basic_saml_edit-2c2eb08e11193bc57194ab1f4d45dff1.png)

   ![A screenshot of the Basic SAML Configuration panel with the Identifier, Reply URL, and Sign on URL filled in](/assets/images/basic_saml_values-731ddb63d5256a2e93cd2ffa5a7934fe.png)

8. Click **Save** and close the **Basic SAML Configuration** panel.

9. In the **User Attributes & Claims** section, click **Edit** and edit the **Unique User Identifier (Name ID)** (click on its name) with the following:

   * **Name identifier format**: `Email address`
   * **Source**: `Attribute`
   * **Source attribute**: `user.mail`

   ![A screenshot of the User Attributes & Claims panel and the Edit button](/assets/images/user_attributes_edit-c5726fe156040721385c45eb29b12cfe.png)

   ![A screenshot of the list of attributes with the Unique User Identifier (Name ID) highlighted](/assets/images/unique_id_edit-7785e8ffe3e7b493824adeaea8995cd9.png)

   ![A screenshot of the Unique User Identifier (Name ID) panel with the Name identifier format, Source, and Source attribute filled in](/assets/images/unique_id_values-675282628fbd8f52fdec7ba8c866caa1.png)

10. Click **Save** and you will be redirected to the Attributes & Claims page.

11. Add the following new claims (Feel free to delete the default ones):

| Name         | Source      | Source attribute  |
| ------------ | ----------- | ----------------- |
| `firstName`  | `Attribute` | `user.givenname`  |
| `lastName`   | `Attribute` | `user.surname`    |
| `department` | `Attribute` | `user.department` |

To assign ABsmartly roles from Azure, also add a `roles` claim, see [Assigning Roles](<https://docs.absmartly.com/docs/Third-party-integrations/SSO/SAML Role Mapping.md>).

![A screenshot of the Add new claim button](/assets/images/add_new_claim-77028e0052ba3f690997c621d53f957c.png)

12. The **SAML Based Sign-on** page should now look like this:

![A screenshot of the completed SAML Based Sign-on page](/assets/images/single_sign_on_result-6f669c51d2904b229e0d74a2307425ba.png)

13. Lastly, in the **SAML Certificates** section, click to download your **Federtion Metadata XML** file, send it to us through email or via Slack and we will have your SSO setup ASAP!

![A screenshot of the SAML Certificates section with the Download button highlighted](/assets/images/saml_certificates-32206d7981ca3bd910524207ff813c75.png)

> **info**
>
> Don't forget to assign users to the application in the **Users and groups** section!
>
> ![A screenshot of the Users and groups section](/assets/images/users_and_groups-a9eefeeced1ff7d98cccb0eafbf84492.png)

## See also

* [Federated OIDC tokens with Microsoft Entra ID](https://docs.absmartly.com/docs/APIs-and-SDKs/Federated-Authentication/microsoft-entra-id.md) — let your own backend call the ABsmartly REST API or MCP server on behalf of users signed in with this tenant.
